###User Defined Function###
_viExecCommand

###Description###
Sendet ein(e) Kommando/Suchanfrage ber eine VISA-Verbindung (GPIB/TCP) an ein Instrument/Gert.

###Syntax###
#include <Visa.au3>
_viExecCommand ( $h_session, $s_command [, $i_timeout_ms = -1] )


###Parameters###
@@ParamTable@@
$h_session
	Ein VISA-Deskriptor (STRING) oder ein VISA-Session-Handle (INTEGER). 
	Ein VISA-DESKRIPTOR ist ein String, die die Ressource spezifiziert, zu der eine Verbindung aufgebaut werden soll.
	Beispiel fr einen Deskriptor: "GPIB::20::0".
	Diese Funktion untersttzt alle gltigen VISA-Deskriptoren, einschlielich GPIB, TCP, VXI und ASRL.
	Eine detaillierte Beschreibung der VISA-Deskriptoren findest du bei den Bemerkungen zu dieser Funktion.
	Als Krzel kann auch ein STRING verwendet werden, der die Adressnummer (z.Bsp. "20") eines GPIB-Gerts statt des vollstndigen 
	Deskriptors (in diesem Fall: "GPIB::20::0") enthlt.
	Ein VISA-Session-Handle ist ein Integerwert, der von _viOpen zurckgegeben wird.
	Es wird empfohlen, das von _viOpen gelieferte VISA-Session-Handle anstatt des Deskriptors zu benutzen, wenn wiederholt auf ein Gert zugegriffen werden soll, 
	da sonst bei jedem Zugriff auf das Gert unntig Rechenzeit fr das ffnen und Schlieen der Verbindung verschwendet wird.
	Nach dem letzten Zugriff auf ein Gert darf das Schlieen der Verbindung nicht vergessen werden (mit _viClose).
$s_command
	Auszufhrende(s) Kommando/Suchanfrage (z.Bsp.: "*IDN?" oder "SOURCE:POWER -20 dBM")
	Eine Suchanfrage muss ein Fragezeichen enthalten (?).
	Wenn eine Suchanfrage gestellt wurde, wird automatisch auf die Antwort des Gerts (oder auf Zeitberschreitung [Timeout]) gewartet.
$i_timeout_ms
	[optional] Gibt die Wartezeit (Timeout) in Millisekunden an. Nur fr Suchanfragen bedeutsam.
	Wenn nicht angegeben, wird der zuletzt benutzte Timeout verwendet oder der Standard-VISA-Timeout.
	Timeouts knnen auch separat per _viSetTimeout gesetzt werden.
	Abhngig vom Verbindungstyp (GPIB, TCP, etc) kann die Timeout-Zeit nicht immer auf den von dir gewhlten Wert gesetzt werden. 
	In diesem Fall wird der nchstgrere Wert gewhlt.
@@End@@

###ReturnValue###
Gibt einen Wert zurck, der davon abhngt, ob eine Suchanfrage gestellt wurde oder nicht und ob die Operation erfolgreich war oder nicht:

* Kommando, Keine Suche:
@@ReturnTable@@
Erfolg:	0
Fehler:	-1, wenn die VISA-DLL nicht geffnet werden konnte,
	oder gibt einen Wert ungleich Null zurck, der dem VISA-Fehlercode (siehe VISA-Programmierhandbuch) entspricht.
@@End@@
* Suchanfrage:
@@ReturnTable@@
Erfolg:	die Antwort des Gerts auf die Anfrage zurck.
Fehler:	-1 wenn die VISA-DLL nicht geffnet werden konnte,
		-3 wenn die VISA-DLL eine unerwartete Anzahl an Ergebnissen liefert,
		oder gibt einen Wert ungleich 0 zurck, der dem VISA-Fehlercode (siehe VISA-Programmierhandbuch) entspricht.
@@End@@
Bei jedem Fehler wird @error auf nicht 0 gesetzt.


###Remarks###
* VISA liefert nur die erste Zeile der Gerteantwort.                   
Das ist in den meisten Fllen kein Problem, da fast alle Gerte mit einer einzeiligen Meldung antworten.

* Es folgt eine Beschreibung der gebruchlichsten VISA-DESKRIPTOREN.
Es gibt jedoch einige weitere Typen, schlage dazu bitte im VISA-Programmierhandbuch nach (www.ni.com).
Optionale Angaben sind in eckige Klammern eingeschlossen ([]).
Board wrde ich mit Baugruppe bersetzen.

Interface   Syntax
------------------------------------------------------------
GPIB INSTR      GPIB[board]::Primradresse[::Sekundradresse] [::INSTR]
GPIB INTFC      GPIB[board]::INTFC
TCPIP SOCKET    TCPIP[board]::Hostadresse::Port::SOCKET
Serial INSTR    ASRL[board][::INSTR]
PXI INSTR       PXI[board]::Gert[::FunKtion][::INSTR]
VXI INSTR       VXI[board]::VXI logische Adresse[::INSTR]
GPIB-VXI INSTR  GPIB-VXI[board]::VXI logische Adresse[::INSTR]
TCPIP INSTR     TCPIP[board]::Hostadresse[::LAN Gertename]
                [::INSTR]

Das Schlsselwort GPIB wird fr GPIB-Gerte verwendet.
Das Schlsselwort TCPIP wird fr TCP/IP-Kommunikation verwendet.
Das Schlsselwort ASRL wird fr serielle Gerte verwendet.
Das Schlsselwort GPIB wird fr GPIB-Gerte verwendet.
Das Schlsselwort VXI wird fr VXI-Gerte (auch fr MXI-Bus-Controls) verwendet.
Das Schlsselwort GPIB-VXI wird fr VXI-Gerte verwendet, die ber GPIB-VXI-Controls kommunizieren.

Die Standardwerte fr die optionalen Argumente sind:

Optionale Angabe          Standardwert
---------------------------------------
board                     0
Sekundradresse           Nichts
LAN Gertename            inst0


Beispiele fr VISA-Deskriptoren (Ressource Strings):
--------------------------------------------------------------
GPIB::1::0::INSTR     Ein GPIB-Gert an Primradresse 1 und
                      Sekundradresse 0 in GPIB-Interface 0.

GPIB2::INTFC          Interface oder raw resource der GPIB-Schnittstelle 2 (<- Rohdaten?).
      

TCPIP0::1.2.3.4::999::SOCKET    Raw TCP/IP Zugriff auf Port 999
                                der angegebenen IP-Adresse.

ASRL1::INSTR          Ein serielles Gert, das an die Schnittstelle ASRL1 angeschlossen ist.  

VXI::MEMACC           Board-level register
                      Zugriff auf das VXI-Interface.

PXI::15::INSTR        PXI-Gert Nr. 15 an Bus 0.

VXI0::1::INSTR        Ein VXI-Gert an der logischen Adresse 1 im VXI-Interface VXI0.

GPIB-VXI::9::INSTR    Ein VXI-Gert an der logischen Adresse 9 in einem GPIB-VXI-gesteuerten System.


###Related###
_viFindGpib, _viOpen, _viClose, _viSetTimeout, _viGTL, _viGpibBusReset, _viSetAttribute


###Example###
@@IncludeExample@@
